MacWorld 2003 July

home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 2003 July / Macworld_2003-07.iso / Data / Software / Reviews / REALbasicMacOSX.sit / REALbasic 5.1 Mac OS X / Read Mes / HTTP Socket Spec.txt < prev next >
MacBinary | 2003-01-16 | 5.6 KB | [TEXT/R*ch]
open in:
MacOS 8.1 extracted |
Win98 extracted |
DOS extracted
browse contents |
view JSON data |
view as text

This file was processed as: MacBinary (archive/macBinary).
Confidence	Program	Detection	Match Type	Support
`10%`	dexvert	MacBinary `(archive/macBinary)`	fallback	Supported
`1%`	dexvert	Swift 3D 3D Graphic `(poly/swift3D3DGraphic)`	ext	Unsupported
`1%`	dexvert	Boost Text serialization `(other/boostTextSerialization)`	ext	Unsupported
`1%`	dexvert	Text File `(text/txt)`	fallback	Supported
`100%`	file	MacBinary II, inited, Thu Jan 16 14:14:23 2003, modified Thu Jan 16 14:14:23 2003, creator BBEdit, type ASCII, 4083 bytes "HTTP Socket Spec.txt" , at 0x1073 1454 bytes resource	default (weak)
`99%`	file	data	default
`49%`	TrID	Macintosh plain text (MacBinary)	default
`33%`	TrID	raw Group 3 FAX bitmap	default (weak)
`16%`	TrID	MacBinary 2	default (weak)
`100%`	lsar	MacBinary	default
id metadata
key	value
macFileType	`[TEXT]`
macFileCreator	`[R*ch]`
hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 14 48 54 54 50 20 53 | 6f 63 6b 65 74 20 53 70 |..HTTP S|ocket Sp|
|00000010| 65 63 2e 74 78 74 00 00 | 00 00 00 00 00 00 00 00 |ec.txt..|........|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 52 2a 63 | 68 01 00 00 00 00 00 00 |.TEXTR*c|h.......|
|00000050| 00 00 00 00 00 0f f3 00 | 00 05 ae ba 4c b5 0f ba |........|....L...|
|00000060| 4c b5 0f 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |L.......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 6c 10 00 00 |........|....l...|
|00000080| 48 54 54 50 20 53 6f 63 | 6b 65 74 20 43 6c 61 73 |HTTP Soc|ket Clas|
|00000090| 73 0a 0a 0a 4f 76 65 72 | 76 69 65 77 3a 0a 09 54 |s...Over|view:..T|
|000000a0| 68 69 73 20 63 6c 61 73 | 73 20 77 69 6c 6c 20 62 |his clas|s will b|
|000000b0| 65 20 75 73 65 64 20 74 | 6f 20 74 72 61 6e 73 6d |e used t|o transm|
|000000c0| 69 74 20 61 6e 64 20 72 | 65 63 65 69 76 65 20 64 |it and r|eceive d|
|000000d0| 61 74 61 20 76 69 61 20 | 74 68 65 20 68 74 74 70 |ata via |the http|
|000000e0| 20 70 72 6f 74 6f 63 6f | 6c 2e 20 20 53 69 6e 63 | protoco|l.  Sinc|
|000000f0| 65 20 74 68 69 73 20 69 | 73 20 61 20 73 75 62 63 |e this i|s a subc|
|00000100| 6c 61 73 73 20 6f 66 20 | 74 68 65 20 62 75 69 6c |lass of |the buil|
|00000110| 74 20 69 6e 20 54 43 50 | 53 6f 63 6b 65 74 20 61 |t in TCP|Socket a|
|00000120| 6c 6c 20 74 68 65 20 73 | 74 61 6e 64 61 72 64 20 |ll the s|tandard |
|00000130| 73 6f 63 6b 65 74 20 41 | 50 49 20 61 72 65 20 61 |socket A|PI are a|
|00000140| 6c 73 6f 20 61 76 61 69 | 6c 61 62 6c 65 2e 20 20 |lso avai|lable.  |
|00000150| 54 68 65 20 66 75 6e 63 | 74 69 6f 6e 61 6c 69 74 |The func|tionalit|
|00000160| 79 20 6f 66 20 74 68 69 | 73 20 63 6c 61 73 73 20 |y of thi|s class |
|00000170| 77 6f 75 6c 64 20 62 65 | 20 61 73 79 6e 63 68 72 |would be| asynchr|
|00000180| 6f 6e 6f 75 73 20 77 69 | 74 68 20 74 68 65 20 69 |onous wi|th the i|
|00000190| 64 65 61 20 69 6e 20 6d | 69 6e 64 20 74 68 61 74 |dea in m|ind that|
|000001a0| 20 61 20 73 79 6e 63 68 | 72 6f 6e 6f 75 73 20 76 | a synch|ronous v|
|000001b0| 65 72 73 69 6f 6e 20 63 | 6f 75 6c 64 20 62 65 20 |ersion c|ould be |
|000001c0| 64 65 72 69 76 65 64 20 | 66 72 6f 6d 20 69 74 20 |derived |from it |
|000001d0| 69 66 20 64 65 73 69 72 | 65 64 2e 0a 0a 0a 50 72 |if desir|ed....Pr|
|000001e0| 6f 70 6f 73 65 64 20 43 | 6c 61 73 73 20 4e 61 6d |oposed C|lass Nam|
|000001f0| 65 73 3a 0a 0a 09 48 54 | 54 50 53 6f 63 6b 65 74 |es:...HT|TPSocket|
|00000200| 0a 0a 0a 0a 4d 65 74 68 | 6f 64 73 3a 0a 0a 09 43 |....Meth|ods:...C|
|00000210| 6c 65 61 72 52 65 71 75 | 65 73 74 48 65 61 64 65 |learRequ|estHeade|
|00000220| 72 73 28 29 0a 09 09 43 | 6c 65 61 72 20 6f 75 74 |rs()...C|lear out|
|00000230| 20 61 6c 6c 20 73 65 74 | 20 72 65 71 75 65 73 74 | all set| request|
|00000240| 20 68 65 61 64 65 72 73 | 2e 20 20 46 6f 72 20 6d | headers|.  For m|
|00000250| 6f 72 65 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 20 |ore info|rmation |
|00000260| 6f 6e 20 77 68 61 74 20 | 61 20 72 65 71 75 65 73 |on what |a reques|
|00000270| 74 20 68 65 61 64 65 72 | 20 69 73 20 73 65 65 20 |t header| is see |
|00000280| 74 68 65 20 6d 65 74 68 | 6f 64 20 53 65 74 52 65 |the meth|od SetRe|
|00000290| 71 75 65 73 74 48 65 61 | 64 65 72 2e 0a 0a 09 45 |questHea|der....E|
|000002a0| 6e 63 6f 64 65 46 6f 72 | 6d 44 61 74 61 28 66 6f |ncodeFor|mData(fo|
|000002b0| 72 6d 20 61 73 20 64 69 | 63 74 69 6f 6e 61 72 79 |rm as di|ctionary|
|000002c0| 29 20 61 73 20 73 74 72 | 69 6e 67 0a 09 09 54 68 |) as str|ing...Th|
|000002d0| 69 73 20 6d 65 74 68 6f | 64 20 74 61 6b 65 73 20 |is metho|d takes |
|000002e0| 74 68 65 20 6b 65 79 2f | 76 61 6c 75 65 20 70 61 |the key/|value pa|
|000002f0| 69 72 73 20 66 72 6f 6d | 20 74 68 65 20 64 69 63 |irs from| the dic|
|00000300| 74 69 6f 6e 61 72 79 20 | 61 6e 64 20 66 6f 72 6d |tionary |and form|
|00000310| 61 74 73 20 74 68 65 6d | 20 69 6e 74 6f 20 61 20 |ats them| into a |
|00000320| 55 52 4c 20 65 6e 63 6f | 64 65 64 20 73 74 72 69 |URL enco|ded stri|
|00000330| 6e 67 2e 20 20 54 68 65 | 20 72 65 73 75 6c 74 69 |ng.  The| resulti|
|00000340| 6e 67 20 73 74 72 69 6e | 67 20 63 61 6e 20 74 68 |ng strin|g can th|
|00000350| 65 6e 20 62 65 20 75 73 | 65 64 20 69 6e 20 74 68 |en be us|ed in th|
|00000360| 65 20 55 52 4c 20 74 6f | 20 73 65 6e 64 20 64 61 |e URL to| send da|
|00000370| 74 61 20 74 6f 20 61 20 | 66 6f 72 6d 20 77 69 74 |ta to a |form wit|
|00000380| 68 20 61 20 47 45 54 20 | 61 63 74 69 6f 6e 2c 20 |h a GET |action, |
|00000390| 6f 72 20 61 73 20 63 6f | 6e 74 65 6e 74 20 66 6f |or as co|ntent fo|
|000003a0| 72 20 61 20 50 4f 53 54 | 2e 0a 09 0a 09 47 65 74 |r a POST|.....Get|
|000003b0| 28 75 72 6c 20 61 73 20 | 73 74 72 69 6e 67 2c 20 |(url as |string, |
|000003c0| 5b 66 69 6c 65 20 61 73 | 20 66 6f 6c 64 65 72 69 |[file as| folderi|
|000003d0| 74 65 6d 5d 29 0a 09 09 | 52 65 71 75 65 73 74 20 |tem])...|Request |
|000003e0| 74 68 65 20 63 6f 6e 74 | 65 6e 74 20 66 72 6f 6d |the cont|ent from|
|000003f0| 20 74 68 65 20 73 70 65 | 63 69 66 69 65 64 20 75 | the spe|cified u|
|00000400| 72 6c 2e 20 20 50 61 67 | 65 52 65 63 65 69 76 65 |rl.  Pag|eReceive|
|00000410| 64 20 65 76 65 6e 74 20 | 77 69 6c 6c 20 66 69 72 |d event |will fir|
|00000420| 65 20 77 68 65 6e 20 74 | 68 65 20 64 61 74 61 20 |e when t|he data |
|00000430| 68 61 73 20 62 65 65 6e | 20 72 65 74 72 69 65 76 |has been| retriev|
|00000440| 65 64 2e 20 20 49 66 20 | 61 20 66 6f 6c 64 65 72 |ed.  If |a folder|
|00000450| 69 74 65 6d 20 69 73 20 | 70 61 73 73 65 64 20 69 |item is |passed i|
|00000460| 6e 20 74 68 65 20 64 61 | 74 61 20 77 69 6c 6c 20 |n the da|ta will |
|00000470| 64 6f 77 6c 6f 61 64 65 | 64 20 74 6f 20 74 68 61 |dowloade|d to tha|
|00000480| 74 20 66 69 6c 65 2e 20 | 20 44 6f 77 6e 6c 6f 61 |t file. | Downloa|
|00000490| 64 43 6f 6d 70 6c 65 74 | 65 20 65 76 65 6e 74 20 |dComplet|e event |
|000004a0| 77 69 6c 6c 20 66 69 72 | 65 20 77 68 65 6e 20 74 |will fir|e when t|
|000004b0| 68 65 20 64 61 74 61 20 | 68 61 73 20 62 65 65 6e |he data |has been|
|000004c0| 20 72 65 74 72 69 65 76 | 65 64 2e 0a 0a 09 50 6f | retriev|ed....Po|
|000004d0| 73 74 28 75 72 6c 20 61 | 73 20 73 74 72 69 6e 67 |st(url a|s string|
|000004e0| 2c 20 5b 66 69 6c 65 20 | 61 73 20 66 6f 6c 64 65 |, [file |as folde|
|000004f0| 72 69 74 65 6d 5d 29 0a | 09 09 49 73 73 75 65 20 |ritem]).|..Issue |
|00000500| 61 20 70 6f 73 74 20 63 | 6f 6d 6d 61 6e 64 20 74 |a post c|ommand t|
|00000510| 6f 20 74 68 65 20 73 65 | 72 76 65 72 2e 20 20 50 |o the se|rver.  P|
|00000520| 61 67 65 52 65 63 65 69 | 76 65 64 20 65 76 65 6e |ageRecei|ved even|
|00000530| 74 20 77 69 6c 6c 20 66 | 69 72 65 20 77 68 65 6e |t will f|ire when|
|00000540| 20 74 68 65 20 72 65 73 | 70 6f 6e 73 65 20 64 61 | the res|ponse da|
|00000550| 74 61 20 68 61 73 20 62 | 65 65 6e 20 72 65 74 72 |ta has b|een retr|
|00000560| 69 65 76 65 64 2e 20 20 | 49 66 20 61 20 66 6f 6c |ieved.  |If a fol|
|00000570| 64 65 72 69 74 65 6d 20 | 69 73 20 70 61 73 73 65 |deritem |is passe|
|00000580| 64 20 69 6e 20 74 68 65 | 20 64 61 74 61 20 77 69 |d in the| data wi|
|00000590| 6c 6c 20 64 6f 77 6c 6f | 61 64 65 64 20 74 6f 20 |ll dowlo|aded to |
|000005a0| 74 68 61 74 20 66 69 6c | 65 2e 20 20 44 6f 77 6e |that fil|e.  Down|
|000005b0| 6c 6f 61 64 43 6f 6d 70 | 6c 65 74 65 20 65 76 65 |loadComp|lete eve|
|000005c0| 6e 74 20 77 69 6c 6c 20 | 66 69 72 65 20 77 68 65 |nt will |fire whe|
|000005d0| 6e 20 74 68 65 20 72 65 | 73 70 6f 6e 73 65 20 64 |n the re|sponse d|
|000005e0| 61 74 61 20 68 61 73 20 | 62 65 65 6e 20 72 65 74 |ata has |been ret|
|000005f0| 72 69 65 76 65 64 2e 0a | 0a 09 53 65 74 46 6f 72 |rieved..|..SetFor|
|00000600| 6d 44 61 74 61 28 66 6f | 72 6d 20 61 73 20 64 69 |mData(fo|rm as di|
|00000610| 63 74 69 6f 6e 61 72 79 | 29 0a 09 09 54 68 69 73 |ctionary|)...This|
|00000620| 20 6d 65 74 68 6f 64 20 | 77 69 6c 6c 20 74 61 6b | method |will tak|
|00000630| 65 20 74 68 65 20 6b 65 | 79 2f 76 61 6c 75 65 20 |e the ke|y/value |
|00000640| 70 61 69 72 73 20 66 72 | 6f 6d 20 74 68 65 20 64 |pairs fr|om the d|
|00000650| 69 63 74 69 6f 6e 61 72 | 79 20 61 6e 64 20 63 6f |ictionar|y and co|
|00000660| 6e 76 65 72 74 20 69 74 | 20 74 6f 20 61 20 55 52 |nvert it| to a UR|
|00000670| 4c 20 65 6e 63 6f 64 65 | 64 20 73 74 72 69 6e 67 |L encode|d string|
|00000680| 20 61 6e 64 20 74 68 65 | 6e 20 61 73 73 69 67 6e | and the|n assign|
|00000690| 20 69 74 20 74 6f 20 74 | 68 65 20 43 6f 6e 74 65 | it to t|he Conte|
|000006a0| 6e 74 20 70 72 6f 70 65 | 72 74 79 2e 20 20 54 68 |nt prope|rty.  Th|
|000006b0| 69 73 20 6d 65 74 68 6f | 64 20 61 6c 73 6f 20 73 |is metho|d also s|
|000006c0| 65 74 73 20 74 68 65 20 | 43 6f 6e 74 65 6e 74 54 |ets the |ContentT|
|000006d0| 79 70 65 20 70 72 6f 70 | 65 72 74 79 20 74 6f 20 |ype prop|erty to |
|000006e0| 74 68 65 20 61 70 70 72 | 6f 70 72 69 61 74 65 20 |the appr|opriate |
|000006f0| 4d 49 4d 45 20 74 79 70 | 65 20 66 6f 72 20 73 75 |MIME typ|e for su|
|00000700| 62 6d 69 74 74 69 6e 67 | 20 66 6f 72 6d 73 20 61 |bmitting| forms a|
|00000710| 6e 64 20 73 65 74 73 20 | 74 68 65 20 61 63 74 69 |nd sets |the acti|
|00000720| 6f 6e 20 74 6f 20 50 4f | 53 54 2e 20 20 41 66 74 |on to PO|ST.  Aft|
|00000730| 65 72 20 75 73 69 6e 67 | 20 74 68 69 73 20 6d 65 |er using| this me|
|00000740| 74 68 6f 64 20 74 68 65 | 20 66 6f 72 6d 20 63 61 |thod the| form ca|
|00000750| 6e 20 74 68 65 6e 20 62 | 65 20 73 65 6e 74 20 74 |n then b|e sent t|
|00000760| 6f 20 74 68 65 20 73 65 | 72 76 65 72 20 77 69 74 |o the se|rver wit|
|00000770| 68 20 74 68 65 20 50 4f | 53 54 20 61 63 74 69 6f |h the PO|ST actio|
|00000780| 6e 2e 0a 0a 09 53 65 74 | 50 6f 73 74 43 6f 6e 74 |n....Set|PostCont|
|00000790| 65 6e 74 28 63 6f 6e 74 | 65 6e 74 20 61 73 20 73 |ent(cont|ent as s|
|000007a0| 74 72 69 6e 67 2c 20 63 | 6f 6e 74 65 6e 74 54 79 |tring, c|ontentTy|
|000007b0| 70 65 20 61 73 20 73 74 | 72 69 6e 67 29 0a 09 09 |pe as st|ring)...|
|000007c0| 53 65 74 20 74 68 65 20 | 63 6f 6e 74 65 6e 74 20 |Set the |content |
|000007d0| 64 61 74 61 20 61 6e 64 | 20 74 79 70 65 20 74 6f |data and| type to|
|000007e0| 20 62 65 20 73 65 6e 74 | 20 74 6f 20 74 68 65 20 | be sent| to the |
|000007f0| 77 65 62 73 65 72 76 65 | 72 20 66 6f 72 20 61 20 |webserve|r for a |
|00000800| 50 6f 73 74 20 63 6f 6d | 6d 61 6e 64 2e 0a 09 0a |Post com|mand....|
|00000810| 09 53 65 74 52 65 71 75 | 65 73 74 48 65 61 64 65 |.SetRequ|estHeade|
|00000820| 72 28 6e 61 6d 65 20 61 | 73 20 73 74 72 69 6e 67 |r(name a|s string|
|00000830| 2c 20 76 61 6c 75 65 20 | 61 73 20 73 74 72 69 6e |, value |as strin|
|00000840| 67 29 0a 09 09 53 65 74 | 73 20 74 68 65 20 76 61 |g)...Set|s the va|
|00000850| 6c 75 65 20 6f 66 20 61 | 20 72 65 71 75 65 73 74 |lue of a| request|
|00000860| 20 68 65 61 64 65 72 2e | 20 20 52 65 71 75 65 73 | header.|  Reques|
|00000870| 74 20 68 65 61 64 65 72 | 73 20 61 72 65 20 73 65 |t header|s are se|
|00000880| 6e 74 20 74 6f 20 74 68 | 65 20 73 65 72 76 65 72 |nt to th|e server|
|00000890| 20 61 6c 6f 6e 67 20 77 | 69 74 68 20 74 68 65 20 | along w|ith the |
|000008a0| 61 63 74 69 6f 6e 20 28 | 47 45 54 2c 50 4f 53 54 |action (|GET,POST|
|000008b0| 2c 65 74 63 29 2e 20 20 | 54 68 65 79 20 63 61 6e |,etc).  |They can|
|000008c0| 20 63 6f 6e 74 61 69 6e | 20 64 61 74 61 20 74 68 | contain| data th|
|000008d0| 61 74 20 74 68 65 20 73 | 65 72 76 65 72 20 6d 69 |at the s|erver mi|
|000008e0| 67 68 74 20 75 73 65 20 | 74 6f 20 70 72 6f 63 65 |ght use |to proce|
|000008f0| 73 73 20 79 6f 75 72 20 | 72 65 71 75 65 73 74 2e |ss your |request.|
|00000900| 20 20 53 6f 6d 65 20 65 | 78 61 6d 70 6c 65 73 20 |  Some e|xamples |
|00000910| 6f 66 20 63 6f 6d 6d 6f | 6e 20 72 65 71 75 65 73 |of commo|n reques|
|00000920| 74 20 68 65 61 64 65 72 | 73 20 61 72 65 20 66 6f |t header|s are fo|
|00000930| 72 20 74 68 69 6e 67 73 | 20 73 75 63 68 20 61 73 |r things| such as|
|00000940| 20 72 65 66 65 72 72 69 | 6e 67 20 70 61 67 65 73 | referri|ng pages|
|00000950| 2c 20 74 68 65 20 63 6c | 69 65 6e 74 20 6e 61 6d |, the cl|ient nam|
|00000960| 65 2c 20 6f 73 2c 20 63 | 70 75 2c 20 65 74 63 2e |e, os, c|pu, etc.|
|00000970| 0a 0a 0a 0a 45 76 65 6e | 74 73 3a 0a 0a 09 43 6f |....Even|ts:...Co|
|00000980| 6e 6e 65 63 74 65 64 28 | 29 0a 09 09 46 69 72 65 |nnected(|)...Fire|
|00000990| 64 20 77 68 65 6e 20 74 | 68 65 20 63 6f 6e 6e 65 |d when t|he conne|
|000009a0| 63 74 69 6f 6e 20 68 61 | 73 20 62 65 65 6e 20 65 |ction ha|s been e|
|000009b0| 73 74 61 62 6c 69 73 68 | 65 64 20 77 69 74 68 20 |stablish|ed with |
|000009c0| 74 68 65 20 73 65 72 76 | 65 72 2e 0a 09 0a 09 44 |the serv|er.....D|
|000009d0| 6f 77 6e 6c 6f 61 64 43 | 6f 6d 70 6c 65 74 65 28 |ownloadC|omplete(|
|000009e0| 75 72 6c 20 61 73 20 73 | 74 72 69 6e 67 2c 20 68 |url as s|tring, h|
|000009f0| 74 74 70 53 74 61 74 75 | 73 20 61 73 20 69 6e 74 |ttpStatu|s as int|
|00000a00| 65 67 65 72 2c 20 68 65 | 61 64 65 72 73 20 61 73 |eger, he|aders as|
|00000a10| 20 64 69 63 74 69 6f 6e | 61 72 79 2c 20 66 69 6c | diction|ary, fil|
|00000a20| 65 20 61 73 20 66 6f 6c | 64 65 72 69 74 65 6d 29 |e as fol|deritem)|
|00000a30| 0a 09 09 54 68 69 73 20 | 65 76 65 6e 74 20 69 73 |...This |event is|
|00000a40| 20 75 73 65 64 20 77 68 | 65 6e 20 74 68 65 20 64 | used wh|en the d|
|00000a50| 6f 77 6e 6c 6f 61 64 20 | 69 73 20 63 6f 6d 70 6c |ownload |is compl|
|00000a60| 65 74 65 20 61 66 74 65 | 72 20 75 73 69 6e 67 20 |ete afte|r using |
|00000a70| 74 68 65 20 44 6f 77 6e | 6c 6f 61 64 55 52 4c 20 |the Down|loadURL |
|00000a80| 6d 65 74 68 6f 64 2e 20 | 20 55 52 4c 20 63 6f 6e |method. | URL con|
|00000a90| 74 61 69 6e 73 20 74 68 | 65 20 75 72 6c 20 74 68 |tains th|e url th|
|00000aa0| 61 74 20 77 61 73 20 64 | 6f 77 6e 6c 6f 61 64 65 |at was d|ownloade|
|00000ab0| 64 2e 20 20 46 69 6c 65 | 20 69 73 20 74 68 65 20 |d.  File| is the |
|00000ac0| 64 65 73 74 69 6e 61 74 | 69 6f 6e 20 6f 66 20 77 |destinat|ion of w|
|00000ad0| 68 65 72 65 20 74 68 65 | 20 64 61 74 61 20 77 61 |here the| data wa|
|00000ae0| 73 20 73 61 76 65 64 20 | 61 6e 64 20 68 65 61 64 |s saved |and head|
|00000af0| 65 72 73 20 69 73 20 61 | 20 64 69 63 74 69 6f 6e |ers is a| diction|
|00000b00| 61 72 79 20 6f 66 20 74 | 68 65 20 68 74 74 70 20 |ary of t|he http |
|00000b10| 68 65 61 64 65 72 73 20 | 74 68 61 74 20 77 65 72 |headers |that wer|
|00000b20| 65 20 72 65 74 75 72 6e | 65 64 20 66 72 6f 6d 20 |e return|ed from |
|00000b30| 74 68 65 20 73 65 72 76 | 65 72 2e 20 20 54 68 65 |the serv|er.  The|
|00000b40| 20 48 54 54 50 20 53 74 | 61 74 75 73 20 63 6f 64 | HTTP St|atus cod|
|00000b50| 65 20 69 73 20 61 6c 73 | 6f 20 70 61 73 73 65 64 |e is als|o passed|
|00000b60| 20 69 6e 74 6f 20 74 68 | 69 73 20 65 76 65 6e 74 | into th|is event|
|00000b70| 2e 20 20 54 68 65 73 65 | 20 63 6f 64 65 73 20 61 |.  These| codes a|
|00000b80| 72 65 20 75 73 65 64 20 | 74 6f 20 64 65 74 65 72 |re used |to deter|
|00000b90| 6d 69 6e 65 20 74 68 69 | 6e 67 73 20 73 75 63 68 |mine thi|ngs such|
|00000ba0| 20 61 73 20 61 20 70 61 | 67 65 20 63 6f 75 6c 64 | as a pa|ge could|
|00000bb0| 20 6e 6f 74 20 62 65 20 | 66 6f 75 6e 64 20 28 65 | not be |found (e|
|00000bc0| 72 72 6f 72 20 34 30 34 | 29 2c 20 65 74 63 2e 0a |rror 404|), etc..|
|00000bd0| 0a 09 50 61 67 65 52 65 | 63 65 69 76 65 64 28 75 |..PageRe|ceived(u|
|00000be0| 72 6c 20 61 73 20 73 74 | 72 69 6e 67 2c 20 68 74 |rl as st|ring, ht|
|00000bf0| 74 70 53 74 61 74 75 73 | 20 61 73 20 69 6e 74 65 |tpStatus| as inte|
|00000c00| 67 65 72 2c 20 68 65 61 | 64 65 72 73 20 61 73 20 |ger, hea|ders as |
|00000c10| 64 69 63 74 69 6f 6e 61 | 72 79 2c 20 29 0a 09 09 |dictiona|ry, )...|
|00000c20| 57 68 65 6e 20 61 20 6e | 65 77 20 70 61 67 65 20 |When a n|ew page |
|00000c30| 68 61 73 20 62 65 65 6e | 20 72 65 63 65 69 76 65 |has been| receive|
|00000c40| 64 20 66 72 6f 6d 20 74 | 68 65 20 73 65 72 76 65 |d from t|he serve|
|00000c50| 72 20 74 68 69 73 20 65 | 76 65 6e 74 20 69 73 20 |r this e|vent is |
|00000c60| 74 72 69 67 67 65 72 65 | 64 20 61 6e 64 20 70 72 |triggere|d and pr|
|00000c70| 6f 76 69 64 65 73 20 74 | 68 65 20 75 72 6c 20 74 |ovides t|he url t|
|00000c80| 68 61 74 20 77 61 73 20 | 72 65 71 75 65 73 74 65 |hat was |requeste|
|00000c90| 64 20 61 6e 64 20 74 68 | 65 20 68 74 74 70 20 68 |d and th|e http h|
|00000ca0| 65 61 64 65 72 73 20 66 | 72 6f 6d 20 74 68 65 20 |eaders f|rom the |
|00000cb0| 73 65 72 76 65 72 2e 20 | 20 54 68 65 20 48 54 54 |server. | The HTT|
|00000cc0| 50 20 53 74 61 74 75 73 | 20 63 6f 64 65 20 69 73 |P Status| code is|
|00000cd0| 20 61 6c 73 6f 20 70 61 | 73 73 65 64 20 69 6e 74 | also pa|ssed int|
|00000ce0| 6f 20 74 68 69 73 20 65 | 76 65 6e 74 2e 20 20 54 |o this e|vent.  T|
|00000cf0| 68 65 73 65 20 63 6f 64 | 65 73 20 61 72 65 20 75 |hese cod|es are u|
|00000d00| 73 65 64 20 74 6f 20 64 | 65 74 65 72 6d 69 6e 65 |sed to d|etermine|
|00000d10| 20 74 68 69 6e 67 73 20 | 73 75 63 68 20 61 73 20 | things |such as |
|00000d20| 61 20 70 61 67 65 20 63 | 6f 75 6c 64 20 6e 6f 74 |a page c|ould not|
|00000d30| 20 62 65 20 66 6f 75 6e | 64 20 28 65 72 72 6f 72 | be foun|d (error|
|00000d40| 20 34 30 34 29 2c 20 65 | 74 63 2e 0a 0a 09 52 65 | 404), e|tc....Re|
|00000d50| 63 65 69 76 65 50 72 6f | 67 72 65 73 73 28 62 79 |ceivePro|gress(by|
|00000d60| 74 65 73 52 65 63 65 69 | 76 65 64 20 61 73 20 69 |tesRecei|ved as i|
|00000d70| 6e 74 65 67 65 72 2c 20 | 74 6f 74 61 6c 42 79 74 |nteger, |totalByt|
|00000d80| 65 73 20 61 73 20 69 6e | 74 65 67 65 72 29 0a 09 |es as in|teger)..|
|00000d90| 09 46 69 72 65 73 20 70 | 65 72 69 6f 64 69 63 61 |.Fires p|eriodica|
|00000da0| 6c 6c 79 20 64 75 72 69 | 6e 67 20 74 68 65 20 64 |lly duri|ng the d|
|00000db0| 6f 77 6e 6c 6f 61 64 20 | 70 72 6f 63 65 73 73 20 |ownload |process |
|00000dc0| 6f 66 20 61 20 70 61 67 | 65 2e 20 20 49 74 20 70 |of a pag|e.  It p|
|00000dd0| 72 6f 76 69 64 65 73 20 | 74 68 65 20 6e 75 6d 62 |rovides |the numb|
|00000de0| 65 72 20 6f 66 20 62 79 | 74 65 73 52 65 63 65 69 |er of by|tesRecei|
|00000df0| 76 65 64 20 61 6e 64 20 | 74 68 65 20 74 6f 74 61 |ved and |the tota|
|00000e00| 6c 42 79 74 65 73 20 28 | 69 66 20 61 76 61 69 6c |lBytes (|if avail|
|00000e10| 61 62 6c 65 29 2e 0a 0a | 09 45 72 72 6f 72 28 63 |able)...|.Error(c|
|00000e20| 6f 64 65 20 61 73 20 69 | 6e 74 65 67 65 72 29 0a |ode as i|nteger).|
|00000e30| 09 09 57 68 65 6e 20 61 | 6e 20 65 72 72 6f 72 20 |..When a|n error |
|00000e40| 6f 63 63 75 72 72 73 20 | 74 68 69 73 20 65 76 65 |occurrs |this eve|
|00000e50| 6e 74 20 69 73 20 74 72 | 69 67 67 65 72 65 64 2e |nt is tr|iggered.|
|00000e60| 20 20 41 6c 6c 20 74 68 | 65 20 73 74 61 6e 64 61 |  All th|e standa|
|00000e70| 72 64 20 54 43 50 20 73 | 6f 63 6b 65 74 20 65 72 |rd TCP s|ocket er|
|00000e80| 72 6f 72 20 63 6f 64 65 | 73 20 61 72 65 20 70 61 |ror code|s are pa|
|00000e90| 73 73 65 64 20 69 6e 2e | 20 20 41 64 64 69 74 69 |ssed in.|  Additi|
|00000ea0| 6f 6e 61 6c 20 65 72 72 | 6f 72 20 63 6f 64 65 73 |onal err|or codes|
|00000eb0| 20 69 6e 63 6c 75 64 65 | 3a 0a 0a 09 09 31 20 2d | include|:....1 -|
|00000ec0| 20 44 6f 77 6e 6c 6f 61 | 64 20 66 69 6c 65 20 63 | Downloa|d file c|
|00000ed0| 6f 75 6c 64 20 6e 6f 74 | 20 62 65 20 63 72 65 61 |ould not| be crea|
|00000ee0| 74 65 64 2e 0a 0a 0a 0a | 45 78 61 6d 70 6c 65 20 |ted.....|Example |
|00000ef0| 63 6f 64 65 20 66 6f 72 | 20 72 65 74 72 69 65 76 |code for| retriev|
|00000f00| 69 6e 67 20 55 52 4c 3a | 0a 0a 09 73 6f 63 6b 65 |ing URL:|...socke|
|00000f10| 74 31 2e 67 65 74 20 22 | 68 74 74 70 3a 2f 2f 77 |t1.get "|http://w|
|00000f20| 77 77 2e 72 65 61 6c 73 | 6f 66 74 77 61 72 65 2e |ww.reals|oftware.|
|00000f30| 63 6f 6d 2f 22 0a 0a 0a | 45 78 61 6d 70 6c 65 20 |com/"...|Example |
|00000f40| 63 6f 64 65 20 66 6f 72 | 20 70 6f 73 74 69 6e 67 |code for| posting|
|00000f50| 20 61 20 73 69 6d 70 6c | 65 20 66 6f 72 6d 3a 0a | a simpl|e form:.|
|00000f60| 0a 09 64 69 6d 20 66 6f | 72 6d 20 61 73 20 64 69 |..dim fo|rm as di|
|00000f70| 63 74 69 6f 6e 61 72 79 | 0a 09 0a 09 2f 2f 20 63 |ctionary|....// c|
|00000f80| 72 65 61 74 65 20 61 6e | 64 20 70 6f 70 75 6c 61 |reate an|d popula|
|00000f90| 74 65 20 74 68 65 20 66 | 6f 72 6d 20 6f 62 6a 65 |te the f|orm obje|
|00000fa0| 63 74 0a 09 66 6f 72 6d | 20 3d 20 6e 65 77 20 64 |ct..form| = new d|
|00000fb0| 69 63 74 69 6f 6e 61 72 | 79 0a 09 66 6f 72 6d 2e |ictionar|y..form.|
|00000fc0| 76 61 6c 75 65 28 22 66 | 69 72 73 74 6e 61 6d 65 |value("f|irstname|
|00000fd0| 22 29 20 3d 20 22 46 6f | 6f 22 0a 09 66 6f 72 6d |") = "Fo|o"..form|
|00000fe0| 2e 76 61 6c 75 65 28 22 | 6c 61 73 74 6e 61 6d 65 |.value("|lastname|
|00000ff0| 22 29 20 3d 20 22 42 61 | 72 22 0a 09 0a 09 2f 2f |") = "Ba|r"....//|
|00001000| 20 73 65 74 75 70 20 74 | 68 65 20 73 6f 63 6b 65 | setup t|he socke|
|00001010| 74 20 74 6f 20 50 4f 53 | 54 20 74 68 65 20 66 6f |t to POS|T the fo|
|00001020| 72 6d 0a 09 73 6f 63 6b | 65 74 31 2e 73 65 74 46 |rm..sock|et1.setF|
|00001030| 6f 72 6d 44 61 74 61 20 | 66 6f 72 6d 0a 09 73 6f |ormData |form..so|
|00001040| 63 6b 65 74 31 2e 70 6f | 73 74 20 22 68 74 74 70 |cket1.po|st "http|
|00001050| 3a 2f 2f 77 77 77 2e 6d | 79 66 6f 72 6d 6c 6f 63 |://www.m|yformloc|
|00001060| 61 74 69 6f 6e 2e 63 6f | 6d 2f 66 6f 72 6d 2e 70 |ation.co|m/form.p|
|00001070| 68 70 22 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |hp".....|........|
|00001080| 00 00 01 00 00 00 05 68 | 00 00 04 68 00 00 00 46 |.......h|...h...F|
|00001090| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000010a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000010b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000010c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000010d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000010e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000010f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001100| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001110| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001120| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001130| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001140| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001150| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001160| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001170| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001180| 00 00 00 48 00 09 4d 6f | 6e 61 63 6f 00 00 00 00 |...H..Mo|naco....|
|00001190| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000011a0| 00 00 00 00 00 00 00 06 | 00 04 00 2f 00 03 02 f9 |........|.../....|
|000011b0| 02 7d 00 2f 00 03 02 f9 | 02 7d ba 4c 7c cf 00 00 |.}./....|.}.L|...|
|000011c0| 01 80 00 00 01 80 00 00 | 00 00 01 00 00 00 04 18 |........|........|
|000011d0| 52 2a 63 68 00 83 00 00 | 00 00 00 00 00 00 00 00 |R*ch....|........|
|000011e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000011f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001200| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001210| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001220| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001230| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001240| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 01 |........|........|
|00001250| 07 43 6f 75 72 69 65 72 | 00 00 00 00 00 00 00 00 |.Courier|........|
|00001260| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001270| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001280| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001290| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000012a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000012b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000012c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000012d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000012e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000012f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001300| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001310| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001320| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001330| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001340| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001350| 00 0a 00 00 00 02 09 48 | 65 6c 76 65 74 69 63 61 |.......H|elvetica|
|00001360| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001370| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001380| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001390| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000013a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000013b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000013c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000013d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000013e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000013f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001400| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001410| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001420| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001430| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001440| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001450| 00 00 00 00 00 00 0c 43 | 6f 6e 66 69 64 65 6e 74 |.......C|onfident|
|00001460| 69 61 6c 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |ial.....|........|
|00001470| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001480| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001490| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000014a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000014b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000014c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000014d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000014e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000014f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001500| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001510| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001520| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001530| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001540| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001550| 00 00 00 00 00 00 00 00 | 01 00 00 01 00 00 01 00 |........|........|
|00001560| 00 00 80 00 00 00 80 00 | 00 00 80 00 00 00 80 00 |........|........|
|00001570| 00 00 00 00 01 01 01 00 | 01 00 00 00 00 00 00 03 |........|........|
|00001580| 00 50 01 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.P......|........|
|00001590| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000015a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000015b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000015c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000015d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000015e0| 00 00 00 00 00 00 00 00 | 00 00 01 00 00 00 05 68 |........|.......h|
|000015f0| 00 00 04 68 00 00 00 46 | 00 5d a0 8c 01 f6 00 00 |...h...F|.]......|
|00001600| 00 1c 00 46 00 01 4d 50 | 53 52 00 00 00 12 42 42 |...F..MP|SR....BB|
|00001610| 53 54 00 00 00 1e 03 ed | ff ff 00 00 00 00 01 ca |ST......|........|
|00001620| 99 dc 00 80 ff ff 00 00 | 00 4c 01 ca 99 e0 00 00 |........|.L......|
|00001630| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001640| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001650| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001660| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00001670| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
+--------+-------------------------+-------------------------+--------+--------+